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SECTION I 
INTRODUCTION 



1-1 GENERAL DESCRIPTION 

The Alphanumeric Re-entrant ON -line Interactive Manaaer (ACRnMM\ r« u- . , 

ACRONIM consists of twelve discrete subprocessors , only one of which is core ...Mint 
would «*« opproximcly 12K of ooro. Th. lowest subproc^oT^,^, ™of co« 

s&^if- - -^-'^ raj. --taw-is: t atinssH- 

1-2 COMMAND FORMAT 

Input to ACRONIM consists of free-format alDhanum»ri^ ^k««^»* .*-• r_ l 
command and arguments, and special character and deS« Thf „ ~ clw •'"'W for *• 

asdesired. Adjoint commas Sp.vseUct ion ofalZ i™ *lS?«fa!?i • T - 
characters associated with ACRONIM commands: a,,aument - There are four spec.al 

card i?£atJV^ ""' character on the input card to ACRONIM, the 
card is treated as a comment card. The use for the feature becomes aooarent 
when programming ACRONIM and a description of the o^mtion^s rehired. 

^SSir. 1 ? h r*" firS t non - b '°"k character on the input 
ward in riS R -° NI ^' fhe / ,nt ^ is trecl-d « o label and the second 
7Zt* • !. T'V U5 L d °f ^ e A CRONlM command. A "word" in this 
context is defined as the alphanumeric string starting with a non -blank 
and terminating on a delimiting character (blank or comma). 

"$" - If a dollar sign is the first character of the command word, it is re- 

oToFF S ° SPeC?d A $ RON1M '^' " *• "n* word is $JoX $ON, 
« hi? ' J u eM r"T?[ Kfc Qre QCted u P° n as Ascribed in Section II. Any 
other word has the dollar sign stripped from it and the first six characters K 
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(or less) are treated as a disc area name and, if this name exists as a 
program file, the program is loaded at the priority of the terminal. 

"*" - If the number sign is the first character of the command word it is 

recognized as a register loading request, and if it appears as the first 
character of any argument, the rest of the argument will be interpreted 
as referring to one (or more) registers. Section 10 describes the registers 
and their use. 

The command word (first word on an input card except for labels) is usually a two 
character word. More than two characters may be input but only the first two will be used. 
Each alphabetic character has a unique meaning for character position 1 and character position 
2 and these are rarely the same. Table 1-1 defines the character meaning. Note that not all 
possible combinations of characters will produce a valid ACRONIM command. Table 1-2 lists 
all of the possible ACRONIM commands, their argument lists and a brief definition of their 
function. There are two groups of commands ACRONIM will accept that do not conform to 
the two character requirement: all record editing commands " - ", are one character in length 
and cannot be other than one character, these are listed in Table 1-3; and the BASIC editing 
commands, which are shown in Table 1-4. The BASIC commands must be spelled out and only 
the correct number of characters will be accepted. 

In fhe evenf of an inva l' d command, or an illegally structed command, an error message 
will be generated. In some instances, the argument list may permit an imbedded sub-command. 
If this secondary command is in error, yet is executable by the ACRONIM system, it is possible 
to unintentionally modify the users disc areas. 

In any event, ACRONIM provides positive response to valid or invalid system commands, 
and will not "hang up". 

Several examples of ACRONIM usage are shown in Appendix B. 

1-3 ARGUMENT FORMAT 

Argument words, which always follow the command word, are either number or text in 
form. In some cases, where an ambiguity is allowed, the argument is tested for a numeric evalua- 
tion and if this fails it is treated as a text argument. Extra arguments on a card will always 
result in a card error response. In this manual, the optional arguments for a command are en- 
closed in parentheses. 

Numeric arguments cannot be negative and may be expressed in decimal or octal. 
Octal constants are prefixed by an apostrophe ('). For some commands, a group of integer 
numbers may be an appropriate numeric input. In this case, the numeric input may take the 
orm "NNN-MMM" where MMM must be greater than NNN. Examples of correct numeric 
arguments are given below: 

7, '777, 43-51, '74-101 

Incorrect argument examples are: 

-8, '781, 41-41, 37-30, '12-11 
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Command Character Definition 


May, J 974 


Character 


Definition 




Column 1 


Column 2 




A 


Advance 


Area 




B 

x^ 1 


Backspace 


Backspace 




C 


Change 


Copy 




D 


Delete 


Down 




E 


Edit 


Edit 




F 


— 


File 




G 


Generate 







H 


— 


t |M 




I 

■ 


Insert 


Input 




J 


~ 


Job 




K 
L 


List 


Key 




M 


Mode 


Maanetic 




N 


— 


Not 




O 


Output 


Output 




p 


" Position 


Priority 




Q 


Query 


/ 




R 


Rewind 


Record 




S 


Set/Spool 


Size 




T 


Tab 


Table 




U 
V 


Update 
View 


Up 
Values 




W 


Write 


Wait 




X 


Dummy 






Y 




__ 




Z 


- 






1 


1 - 
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Table 1-2. ACRONW Commands 




Table 1-3. Record Editing Commands 



Command 



A 

B 

C 

D 

I 

L 

P 



Function 



Advance Column Pointer 

Backspace Column Pointer 

Change Characters 

Delete Characters 

Insert Characters 

List Edit Line 

Position Column Pointer 



Table 1-4. BASIC Editing Commands 



Command 



BASIC 

DELETE 

KEY 

LIST 

NEW 

"NNN" 

OLD 

RENAME 

RUN 

SAVE 

UNSAVE 



Function 



Set BASIC Mode 
Delete lines 
Password for file 
List BASIC program 
Create new file 
BASIC statement number 
Get old program 
Rename program 
Execute BASIC program 
Save program 
Delete Program 



j-p •* Tex ' a /9 urn * nt ? m °y c° ns «st of any character string. Blanks and commas are normal lv 

tZl onmlw; nC T de ^ Wf "T ? Char ° c '?7 trin9 ' fh6 Wh ° ,e $ * ?na ™ 5 ' b « s 
quotation marks ( •). To enter a quotation mark (■') in such an enclosed string it must be entered 

™d L j£ Mr^! r POSl *T*' J° ble ] ' 5 COntaJns exam P ,es of Afferent character str^as 

and how they would be interpreted as discrete arguments. 9 
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DISC AREAS 



~h a * l re n! 5 ° s ' andord se r f of d,sc areas associated with each terminal. Each area may be 
ATrSm/S &/ T* nome : u from «"V tarmlnql but the name is recognized and modified by 
ACRON M be fm accessing the area. All standard disc area names consist of two character 

CA^ZlSTi Vt ]e \' 6 ' t0 ? ethe / wFth th ? fr default Slzes in S6c ' ors and *'• type. The name 
£mS tnA C h° ' y 97.f . referenc ' n ? ' for exampl * a dlsc area C4: / 27 whe ' e the » :/» are standard 
terminal Th,< J J ,' S "" 0ctar u re P^^^ion of the physical device number of the input 
?lrt iS'f • TT'uT' 6ach accessin 9 "a" C4 area will only access the C4 area associated 
areL^ncrr ^ fhey M °P e . roM ?9- Permanent information is not stored in these 
areas since the next user may overwrite the file. However, the files C2 through C9 can be used 

7dte!?A&*nXlu n,e$ - ^^ ' d bS remembe, - ed ^ot when accessing rtS? fl£ Slide of 

usfd as « 5^?^ n C °^ mand ' ** C °7 eCt " dl$C T a name must be ^PP' 1 ^- CI can also be 
used as a scratch f.le; its only unique function is that an OLD request will codv the oroaram 

commands'. All new lines to be entered into the editing disc area (changes and inserts) are 
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pre-stored in RC. ED conjoins the order end information relevant to the editing which enables 
an update to take place. TP is a disc area that is temporarily created by an update request and 
normally will not be present. 

All the standard disc areas (CI thru C° and RC) may be redefined in terms of size via 
the set up command which must be the first command given to ACRONIM after a $OFF (i.e., 
terminating request). The size of ED is 20 sectors and cannot be modified via the set up request. 



Table 1-5. Text Arguments 



Argument 


Definition 


ABfe^oEFGH 


Two arguments: AB and EFGH 


"ABJ^EFGH" 


One argument: ABJ^EFGH 


A"CDj#$EF 


Two arguments: A" CD and EF 


"A"CD)£EF 


Three arguments: A, CD and EF 


"A""CQ#*EFG" 


One argument: A"CQ$*EFG 


"55,'U,XCDE" 


One argument: 55/ 17,XCDE 


"55"AB0Q*D" 


Four arguments: 55, AB, C and D" 



NOTE: ¥> = blank or space 



Table 1 -6. Standard Disc Areas 





Name 


Size 


Type 




CI 


40 


Blocked 




C2 


40 


Blocked 




C3 


40 


Blocked 




C4 


40 


Blocked 




C5 


40 


Blocked 




C6 


40 


Blocked 




C7 


40 


Blocked 




C8 


40 


Blocked 




C9 


40 


Blocked 




RC 


240 


Blocked 




ED 


20 


Unblocked 




TP 


- 


Blocked/Unblocked 
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TCB AND PERMANENT AREA 



ACRONIM can only be operated from a terminal. Terminals and their operation are 
described In the DMS manual (AA61 600-02). Associated with each terminal is a terminal control 
block (TCB) that is a table of 21 words which define parameters associated with the particular 
terminal and holds information relevant to the spooling system and ACRONIM. 
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t T ha e n\ C |0^ r ;r ! C n» t T rminal ls P erm ° nen "y res ! den t !" DMS. When an ACRONIM command (other 
than SJOB) is input, a permanent area associated with the terminal is created. ! 

The size of the permanent area is determined by a parameter in the TCB which is set at 

c y £e?J*2T Ti ' m !. M mQy . be ^'^ V5 ° tbe Set table co ™° nd - The permanent area V 
created and mt.al.zed on receipt of a ACRONIM command, other than $JOb7 after a $OFF or ST 
command. No other commands can clear or re -initialize the permanent area. An abort request 
does not affect any of the permanent area parameters. request 

1-6 DISC AREA TABLE 

Since the only resident part of ACRONIM is the permanent area, a Dfsc Area Table is 
created in the permanent area The table is used to keep track of record positions within the 

?hrl ar< V| e S ' Z f ° f *V abb L S defined by ° pamm6ter in fhe TCB ' E °<* •"** in the table is 
three words long, ^o words for the program name and one word for the current record pointer. 

Every due area referenced by ACRONIM is entered into this table and initially rewound l7 
enTries 6 neCe$Sary f ° dear al1 or cer ' aIn disc areas from thIs **'• periodically to reclaim table 

1-7 ACRONIM STRUCTURE 

Every command to ACRONIM is scanned by a re-entrant, non-resident interpreter 
program Th.s program determ.nes the subprocessor that must be loaded to operate on the command 
supplied The second program loaded (also re-entrant and non-resident) will evaluate the ^ 
command and .ts arguments and perform the operation requested. If it is necessary to execute 
another program m perform. ng the operation, the new program is loaded and the old unloaded 

SC^aJSm & re,0a - 6 - ° n COm P ,eMon of > he " ew P^ram **.) Thus fo any uTer 
only one ACRONIM program is in memory at any time. 
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SECTION II 
GENERAL CONTROL COMMANDS 



2-1 GENERAL 

♦ u- u Thts se . cHon describes the general parameter setting commands of ACRONIM which 
establish operating modes, default parameters and provide overall control of ACRONIM. 

Miscellaneous commands which do not fall into any other category are also described 
in this section. 

The argument lists associated with the commands use the following abbreviations: 

NAME = Disc Area Name 

NAMEn = Disc Area Name, where n Is an integer used to differentiate names. 

D,Dn = Device Number (or name), and n is used to differentiate devices. 

N,Nn = Positive Integer value. 

Ni-Nj = Range of integer values. 

Parenthesized arguments are optional. 
2-2 $ON 

tow , ^ l° N J . comm , and f . is onlv required in a DMS system which includes accounting. The 
SON command must be the first command issued following a $OFF command. 

The form of the command is: 
$ON,UNl 
where UNI is the user number and can be entered in one of the following forms: 

Unnn 
nnn 

where nnn is a digit string. No imbedded blanks are permitted, in either form. 

tncc If $C *. N lament is entered other than as the first statement it will be treated as a 
SOFF command and an error code will be issued (CD71). The $ON statement must then be 
re-entered. 

2-3 $OFF 

a *u f " f P ur . cha '; acters ar f necessary and there must be no arguments. This command closes 

& n thi e tS5 ,na and ( J? US6S ^ P e f rmanent areQ fo be ^located. It is strongly recommended 
t»at the $OFF command be entered first when using a terminal. This clears all parameters and 
options set by the previous user. y 

2-1 
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2-4 SET UP (SU) 

If this command is used, it must be the first non-$JOB command supplied to the terminal 
after restarting the terminal from a $OFF condition after the $ON command. The form of the 
command is: 

SU,NAME1,N1,NAME2,N2,NAME3,N3,. ...... 

where: 

NAME is a standard terminal disc area (CI - C9,RC) and the number (N) following each 
area name is the size of the area, in sectors, that is required. Any or all of the standard disc 
area^ names may be defined with this command. The arguments must be in pairs, i.e., a standard 
terminal disc area name followed by a number. Those disc area sizes not defined! on the SU 
card will be the default size, as shown in Table 1-6. 

If an SU command is not supplied as the first non-$JOB ACRONIM input card, one 
of the following two cases will occur: If the ED disc area is defined, the current size definition 
of all the standard disc areas will remain unchanged. If the ED disc area is not defined, e. g. , 
after a system generation, all the standard disc areas will be generated with the sizes given in 
Table 1-6. 

2-5 $JOB 

All four characters must be present followed by a delimiting comma or blank. The 
form of the card is: 

$ JOB, (NAME), (UNI), (DN2), (IN3), (L N4), (PN5) 
$JOB,NAME,UNl,(DN2),(IN3) / (LN4),(PN5) 

The First form is for non-accounting systems. All arguments are optional. 

The second form is for systems where accounting is implemented. NAME and User 
number are required entries. 

In either form NAME must be the first argument in the list. The remaining arguments 
may appear in any order. 

The arguments definitions are: 

NAME - is the identification name associated with this background job. 

UNI - is the user name and an example of the format is U2315. No imbedded 

blanks are permitted. 

DN2 - is the physical device number or disc area name to which the list 
output (LFN 6) is to be sent. An example of the numeric form is 
D41. If an area name is used, e.g., XSAMY, the form is DXSAMY. 

The default DN1 is the device from which the $JOB card was entered. 

IN3 - is the input disc area size parameter. N3 is the size of the area in 

sectors. Default N3 is the value specified at system generation. 



2-2 



LN4 - is the list disc area size parameter. N4 defines the size of the output 
spooled area. Default N4 is a system generation parameter. 

PN5 - is the priority of the job and determines where the job is entered in 
the background job queue. Default N5 is the terminal priority. If 
N5 exceeds the limit for the terminal, the priority is set to the 
default value. 



The $JOB command suspends ACRONIM interpretation of subsequent input records 
lull !---i- _ "V s encounfored -. These input records are spooled and on receipt of the $EOJ 

iate 
lterpreter. 



um... u jilvu is encounrerea. i nese input records are spooled and on receipt of the $ 
the spooling input disc area is entered into the background job queue at the approprh 
priority. The input following the $EOJ is scanned by the ACRONIM interpreter 



2-6 CHANGE KEY (CK) 

• ii l Th f 9 iange Ke Y ( CK ) command allows the user to change the disc area password that 
will be used when accessing disc areas (including generating and deleting disc areas). The 
form of the command is: 

CK,NAME or CK,0 

where : 

NAME is six or less characters (the first of which must be alphabetic). NAME will 
become the new password for the terminal. A zero will remove the password for the terminal. 
On starting up ACRONIM, the password is set to zero. 

2-7 KEY (KEY) 

The KEY command has the same form as the CK command, and is used with BASIC. 

2-8 CHANGE PRIORITY (CP) 

The user may change his terminal priority within the limits determined at system 
generation time. The form of the command is: 

CP,(N) 

where: 

• fl, Trn N 'tu Tr be i bef . we . en . ] °? d 254 - Defaulf ls fhe svstem generation priority (given 
in the ICB). The default priority is the priority of the terminal upon starting ACRONIM. 

2-9 CHANGE INPUT (CI) 

The default or standard input comes from the terminal. However, it is possible to 
temporarily assign the input command device to be a disc area. The Change Input command 
does this and its form is: 

CI, (NAME) 
2-3 



where: 



NAME:, if supplied, must be an existing disc area. The next command input will be 
the record after the current record pointer for this disc area. This command is very powerful 
when used with the registers (Section 10) for programming ACRONIM. When NAME is not 
supplied, command is returned to the standard terminal input device. If an end of tape (EOT) 
is encountered on the command input disc area it is treated as a "CI" with no arguments. An 

VZ^Ull? ( . ' ° n e command dJsc area ^ ignored and the next record is read. On startina 
ACRONIM, the input device is the terminal. 

2-10 REWIND INPUT AND CHANGE INPUT COMMAND SOURCE (RI) 

The RI command performs the same function as the CI command, but rewinds NAME 
prior to transferring the command stream. The form of the RI command is: 

RI,(NAME) 

2-11 OUTPUT AREA (OA) 

This command has relevance only for alphanumeric terminals and is ignored for non- 
alphanumeric terminals. Whereas output is directly printed on a teletype, the corresponding 
output tor an alphanumeric terminal goes to the output disc area which in turn is set into the 
view mode (Section V). This retains a permanent copy of the data on the output disc area 
By changing the output disc area the data is retained "permanently". Examples of the use " 
of output to the alphanumeric terminal via an output area are: the List command in the record 
editing mode, and the List Table Entries command. Directly requested "list" and "view" are 

^LZY tL° n 6 A OA COm "] and ' but T* i 6 ° n,y direct 'y OU 'P ut rea - uests *> on alphanumeric 
terminal. The OA command enables the d.sc area that is currently defined as the output area 
to be changed. The form of the command is: 

OA,NAME 

where: 

NAME is a disc area name. An invalid name will leave the original output area 
unchanged On starting ACRONIM for an alphanumeric terminal, the ou'tput or2 is defined 
?u u /-o b een created. If C9 does not exist, C8 will be used, etcf, through C2 If C2 

XtaZTnT^:? ACR ° NIM W? " "<* ""* ■*■ F ° r alphanumeric tU^tf 

2-12 OUTPUT WAIT (OW) 

The Output Wait command enables the terminal to be turned off without destroying the 

whT "he Q a Z', i ? a °: u ; e i s to enable back 9 r r nd s p° oled ™w *> b « »* ' ' * ^1 

When the output has finished, the user can restart the terminal and continue the ACRONIM 
command sequence he was entering. The form of the command Is: ^^.ni/vi 

OW 



2-4 



2-13 LIST TABLE ENTRIES (LT) 



listed on rh" Xut'devi ce ostoto^d wi Ih^ ^"T^ ^f^ Cl 7 en ' record i>™«°™> -e 



LT 
2-14 DELETE TABLE ENTRIES (DT) 



Disc areas 1 Fn SZuST* •' ^ '° T^T dIsCrete , dlsc area "<""« *«" the disc area table 



DT,NAME1,NAME2,NAME2. 
OR 
DT,ALL 



area tab,. ,..«. oufp S f disc Qroa If Z^fclTl^S IllSlj."^ '" "" ""< 
2-15 SET TABLE SIZE (ST) 

ST,T,N1,N,N2,D,N3 
where: 

mreger number. The ST command mod f es a parameter in the TCR h..t tkic ,J~ , * l iL 

number of registers or the number of rW h,kl-- ♦ • ?-i *? oes not chan 9 e th« 

2-16 MODE VALUES (MV) 
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MV,MODE1,MODE2,MODE3. 



w 



here: 



MODE1, etc., are two or more alphabetic characters which are defined in Table 2-1. 

When an invalid name or option is encountered, the rest of the requested modes are 
ignored and an error code is output. The modes requested before the invalid request are set. 
Table 2-1 lists the mutually exclusive options and modes that can be set. 

When ACRONIM is initialized the modes set are AB,SI,NU,DI,and CA. 

Table 2-1. Mutually Exclusive Modes and Options 



Mode/Option 


Possible Mode Values 


Record Numbers 
Processor Mode 
Output Line Size 
Updating Mode 
Format Control 


ABsolute, RElative 

ASsembler, BAsic, FOrtran, NU1 1 

Single, DOuble, TRiple, Quadruple 

Continuous, Discontinuous 

CArriage control, NO carriage control 



2-16. 1 ABsolute (AB) 



All record numbers supplied by the ACRONIM user for listing, viewing, and editing 
are absolute; i.e., they ar- relative to the beginning of the disc area supplied. 

2-16.2 RElative (RE) 

The record numbers supplied are relative to the current position within the disc area. 
In the relative mode, a record number of zero will refer to the record at which the disc area 
is positioned. 

2-16.3 Assembler (AS) 

The assembler mode sets TAB fields at columns 9, 15 and 30. Thus, when entering 
source editing commands (RC, CR, IR) and the tab key is used as an input character, it Is re- 
placed by blanks up to the next tab field marker. After the last tab field number, the tab key 
is entered as a regular character, as it is when no tab fields have been set. This saves the 
ACRONIM user having to count blanks while entering assembly language programs. 

When a program is "listed" or "viewed" on a teletype in the assembler mode all blanks 
but one preceding a tab field marker are removed. If an asterisk is the first character of the 
record the tab fields are not applicable. This compression enables the ACRONIM user to get 
a faster listing than would otherwise be possible. Note that this feature can be suppressed if 
a standard listing is required: changing from the "ASsembler" mode to the "NU11" mode before 
entering the list request provides the usual format for the assembly listing. 
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2-16.4 BAsic (BA) 



TV. J BACir 6 $ ° re dear6d f ° r the , BASIC mode and the continuous updating mode is set. 
This enables BASIC programs to appear to be edited continuously. Special "number" command 
codes are accepted m th.s mode, thus allowing the user to enter BASIC statements as though they 
were regular ACRONIM commands. The CR and IR commands are not allowed in the BASIC 
mode, 



2-16.5 FOrtran (FO) 

f l TH 7 F S/ r u rQn m ° de is V ? ry , sFmi . lar fo the ASs '*"bler mode except that one tab field is set 

for column 7. When a program is listed in the FOrtran mode on the teletype, extra blanks before 
column 7 are ignored except for those records with a C in column one. 

2-16.6 NU11 (NU) 

This removes the current processor mode and clears all the tab fields values. A tab 
key entered in this mode will be stored as the tab character. 

2-16.7 Single (SI) 

If, in the Single line mode a record contains more characters than the number of 

of X C rn, r L Per ?• °7 he ?7 e 4 nt ou ;P£ devi <^ truncation will occur. The maximum number 
of characters per line for a teletype is 72, and 80 for an alphanumeric terminal. 

2-16.8 DOuble (DO) 

*u- • } n I*! 6 D ,° uble line mode a rec °rd twice the size of the input buffer is read. When 
rh.s is output to the appropriate device it will use 2 output lines if the double input buffer size 
cannot be contained in one output line. e 

2-16.9 TRiple (TR) 

* * .u In the l Rlp .\f line . mode a record *ree times the size of the input buffer is read When 
fewer l^s r6qUire UP *° 3 ° U ' PU ' UneS ,f "" lnfo "™' io " caEnoT be contained in 

3-16. 10 Quadruple (QU) 

ru- !? Hl L QUadru P ,e 'j ne mod « a record four times the size of the input buffer is read 

to be' written" ^^ "'" "'* *""' °' '*"' ""•' depend?ng ° n the " Umber of ^l^ 

?-16 11 Continuous (CO) 

When in 'he Continuous mode, the program being edited will be updated (if there have 
been ed.t.ng requests) when a list request for the edit area is received. Thus any record numbers 
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on the listed output will reflect the editing previously requested. This means that record numbers 
may be continuously changing, and, as a result subsequent records to be edited may have new 
record numbers. When in the BASIC mode (which automatically sets the Continuous mode), the 
RUN command forces an update of the edit area before being undertaken. 

2-16.12 DIcontinuous (DI) 



This command removes the COntinuous mode so that updating of the edit area only 
occurs when a UA request is encountered. This means that a list of the edit file during an 
editing sequence will not reflect the changes requested and the records will still be numbered 
as they were prior to beginning the editing requests. 

2-16. 13 CArriage Control (CA) 

When the CArriage control mode is set, every record copied to a terminal is prefixed 
with a blank character which is interpreted by the terminal handler as a carriage control character 
(and ignored). Thus the record output is the same as from the input device. 

2-16. 14 NO Carriage Control 



For copies to the terminals, the first character of the record read from the input device 
is treated as a carriage control character by the terminal handler. This mode is useful to obtain 
hard copies of assembly and FORTRAN listings originally written to disc areas. 

2-16. 15 HOId (HO) 

The HOId command can be used only when the ACRONIM input command device is a 
disc area. The command causes all subsequently loaded ACRONIM subprocessors to remain in 
core when their current tasks are finished, thus decreasing the user's throughput time since the 
ACRONIM subprocessors need not be loaded in the usual fashion (refer to Paragraph 1-7). Note 
that up to I2K of core may be required for this mode of operation (depending on the number of 
ACRONIM subprocessors needed to perform the specified tasks). 

The HOId mode is reset when the command stream is transferred' to the terminal. 

2-17 BASIC (BASIC) 

The BASIC command is equivalent to an MV,BA command, which sets the BASIC mode. 

2-18 TAB VALUES (TV) 

The Tab Values command allows the ACRONIM user to set tab field (up to a maximum 
f eight) for his own special applications. This command can be used to change standard tab 
;lues set by a mode command. The maximum tab value is 254 and the arguments on the tab 
vulue card must be in ascending order of magnitude. The TV card form is: 

TV,(N1),(N2),(N3)... 

where: 

Nl, N2, etc. are the new tab values required. 

2-19 RUN (RUN) 

RUN is the command which enables a BASIC program to be compiled and executed. 
The form of the command is: 

RUN,(NAME),(N) 
2-8 



w 



here: 



m • *u NA i^ E ' S r the VT 6 °J fhe P r °9 ram ( d »sc area) that is to be compiled and executed and 

On'.* l e dn!T- %;« mod V leS f ° f mem ° ry ? * a " OCated ?n which * buMd P the BASIC >og am 
One module is 768 words of memory and the default N is unity. When NAME is «,nnSw?«^ 
there ,. a program in the editing mode, the names must be U^™^hu\t^M?h& 
disc area ,n the editing mode. When there is a disc area in the editing mode an ^ ; s *' 
performed before transferring control to the BASIC compiler. The disc area is not r*m™J I ft, 

ACRO^IdT " tHe ^W C u han9 ! d b >I -"-^he-BASIC d c^pMe a r. ,S Th s*"^ 
ACRONIM editing may ■ mmed.ately be undertaken on the same disc area without redefinina the 
ed.t.ng d.sc area name or specifying the BAsic mode. reaet.nmg the 



2-20 REPROCESS COMMAND 0040 



Certan ACROnS?^ command , wh '^ ■» all blanks is treated as a special "repeater" commpnd. 
Certan ACRONIM commands can be given, with no arguments, which do more than set modes 
These are known as repeater commands. The last such given before the receipt of thTbTank 
record ,s .mt.ated. The following commands are repeafer commands: LU, LD, LR VU VD VR 



2-21 LIST VALUES (LV) 



The List Values command is only meaningful if the user is operating from an alphanumeric 
It allows the user to dedicate certain output lines to LIST request! The form of the 



termina 
command is 

LV,(N1,N2) 

OR 

LV,(N3-N4) 
where: 



Nl is the line number at which to start all LIST outputs to the terminal and N2 is the 
number of hnes ma LIST page. N3-N4 specifies the starting and ending iTst line numbe on the 

one m i e n s a thanThe It'f^ T^ ,tartin P ^ *° u !»* ™ d *» number of lines per page to 
one less than the physical number of lines on the terminal. 

2-22 VIEW VALUES (VV) 

The View Values command is similar to the List Values command. The definition of the 
start.ng l.ne and page size is applicable only to VIEW commands. The form of the command is 

VV,(N1,N2) 

OR 
VV,(N3-N4) 



wh 



rare: 



uw tn J^riTIT* are ■' defined f ° r the LV comma "d. The LV and W commands enable the 
"her P alphanumeric output screen and have VIEW and LIST displays not overwrTre each 
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2-23 INSERT JOB (IJ) 



* a ■ i i nS t ^° command enables a disc area consisting of Job Control statements to be 
entered mto the background spooled input queue. ACRONIM reads the first record on this disc 
area and ensures it is a valid $JOB card. The list output device parameter (DN2, Section 2-5) is 
required on the $JOB card in a disc area on which an IJ command is to be performed. The form 
of the command is: 

U,NAME 
where: 

NAME is the name of the disc area containing the job stream input commands. NAME 
may be a private disc area (accounting systems only) but may not have a password associated 

2-24 SET SIZE (SS) 

tu a c L h6 . S6f . S? o e i c ? mmand allows the us «r *o change the size of the input (working) buffer 
The default s.ze ^ 81 characters and this may be varied up to 1000 characters. On receipt of 

feNW^^rr^if^ tiro* SiT&'-r «Kii- 

11 S^^^^ — editing^m^tld 

SS,N 



where: 



N is the number of characters required in the new buffer. 

2-25 SPOOL OUT (SO) 

The form of the spool out command is: 
SO, NAME, N 

Where NAME is a disc area name and N is the physical device number of the device to which 

dir°N % PU 'I *°> b V!. nt ' ° ISC are ° NAME is e " tered '"*> the spool queue Torohyscal 
dev.ce N. The contents of disc area NAME should be directly listable, i. e , carriage contra 
characters, ,f appropriate, must be within the records in the disc area. 9 

2-26 SET MAG TAPE OPTIONS (SM) 

The form of the SM command is: 

SM, N / T0,556BPI,3CPW, EBCDIC 

Where N is the physical device number of the mag tape and must be the first argument supplied 
TI.e .emaming arguments can be in any order but must be of the form shown: denies (BPI) can 
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be 200, 556, 800 or 1600, there may be 1, 2, 3, or 4 characters per word (CPW), specifiable 
modes are EBCDIC, BCD, ASCII, BINARY, the transport, which must be supplied is specified in 
the form TO, Tl, T2, etc. 

The mag tape options are used by ACRONIM for all commands which operate 
on mag tapes. If the physical device specified on a command matches a physical 
device number supplied on either of the last two "SM" requests, then the 
options associated with this PDN are used as the mag tape options for the operation. 

. Ma9 f ape °P Hon$ are SQ ved for 2 physical devices. New options for an already aiven 
PDN updates the options for that device. For example: 

SM, 11, 3CPW, EBCDICT0 

SM,12,4CPW,BINARY,T1 
Tape options are now saved for PDN 1 1 and 12 

SM,15,4CPW,ASCII,T4 
Tape options are now saved for PDN 12 and 15 

SM,12,3CPW,BINARY,T1 
Tape options are now saved for PDN 12 and 15 

SM,14,2CPW,556BPI,T3 

Tape options are now saved for 12 and 14 (last 2 physical devices for which tape options 
were supplied. For options that are not specified explicitly the defaults set at sysaen time in 
the SYS DAT module are used. 



2-27 Delete Workarea (DW) 

The Delete Workarea command enables the user to delete an ACRONIM TP area 
which may remain from an incomplete update area attempt. If this TP area is 
private under another user number, the current user cannot delete it using the 
Delete Area (DA) command. The Delete Workarea command will delete the TP area 
without checking access. This command is useful after receiving an ACRONIM 
error code 30. The form of the Delete Workarea command is 

DW.TP 
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SECTION III 
COPY COMMANDS 

3-1 GENERAL 

The copy commands provide means of copying source images from one physical device 
or disc area to another. Output rothe line printer is set at 55 lines per page. The SInqle 
re uest age C ° nfro1 ° nd N ° carriaae confro! modes °Pp'y particularly to the copying 

The argument lists associated with the copy commands use the following abbreviations: 

Dn = Disc Area name or Physical Device number. 

R = Record 

F = File 

A = Area 

NAME = Disc Area Name 

Parenthesized arguments are optional . 

3-2 REWIND AND COPY (RC) 

The form of the rewind and copy command takes one of the following forms: 

RC,D1,D2,R,(N1) 
RC,D1,D2,F,(N1) 

RC,D1,D2,A 

where: 

Dl and D2 are , respectively, the input device and the output device (either or both 

aT/to'be'co^ed T^-™? V'*^ A ''^V* * e C ° Pying mode ' R "*"«*» '^ records 
hi 1 -n ISt ' ■ IT* ^ f ' QS ° re ,l° be C °P' ed ' and A ' (° n| y applicable when Dl 
.s a d.sc area,) copies until an end of tape (EOT) is encountered on Dl . Nl is an optional 
integer number that specifies the number (default unity) of records or files to be cooied 
Before copying the first record, both Dl and D2 are issued rewind commands Kth2? m no 
may.be .placed by " ■ if the input or output device is the ^iT^t^t c'omlnd 

To copy a disc area to the terminal the command would have the following form: 

RC,FILE,*,F 
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3-3 LIST AND COPY AFTER REWIND (LC) 

[his command has the various forms given below: 

LC,D1,D2,R,(N) 
LC,D1,D2,F,(N) 
LC,D1,D2,A 



The only difference between this command and the RC command is that each record 
output is preceded by a line number. This enables the ACRON1M user who has access to a 
line printer to get a sequenced listing of his program more quickly than waiting for the Teletype 
to list it. It is not possible to list and copy without rewinding, so the first part of a disc area 
cannot be skipped over. 

3-4 COPY (XC) 

The XC command has the forms: 

XC,D1,D2,R,(N) 
XC,D1,D2,F,(N) 
XC,D1,D2,A 



The only difference between XC and RC is that for XC commands neither the input 
nor the output devices are rewound before the copying begins. Thus, positioning commands must 
be issued prior to the XC command in order that the copy start in the correct place. 

3-5 OLD (OLD) 

This command, included for compatibility with BASIC programming requirements, has 
the following form: 

OLD, NAME 
v here: 

NAME is an existing disc area. The OLD command is equivalent to: 

RC, NAME, CI, A 

where: 



Jisc area 



On completion of the copying, CI is set into the editing mode. If there already is a 
in the edit mode, CI will not be set into the edit mode. 
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3-6 NEW (NEW) 

the follovJin 5 form mand ' inC ' uded f ° r Com P aHb!lJt y with BASIC programming requirements, has 

NEW,NAME,(N),(R),(W),(D) 

U- U ^u AA i- E mUSf b l, U A n 4 C l e r fi . ned f 50 area name and N ' ( def< ™lt unity) is the disc pack number 
on which the disc area NAME is to be created. The size of NAME that is created is40 sectors 
(sufficient for most BASIC programs) and the type is "B6" (refer to Paragraph 9-2). After creation 
of the disc area, it .s rewound and a file mark written as the first record. NAME is set into the 
editing mode on the assumption the BASIC user (or other user) will now enter his program The 
R, W, and D parameters allow Read, Write arid Deletion access by a user other than the user 

7l D Cr ?Z _, t e e * The P aramefe " may be entered in any order. If NAME already exists 
the R, W and D parameters are not valid. r 

Note that it is necessary to distinguish between the use of CI with the OLD and NEW 

n°MFWMAMP "in 6 : USed u wi ^ NEW - T h L ence a SAVE,NAME after entering a program following 
a NEW,NAMEwi I destroy the program. The contents of CI (which may be ambiguous at this 
point) are copied into NAME, overwriting the program just entered. For an OLD request, CI 
is used and is the file in the editing mode. Thus when a new version of NAME has evolved and 
is to be saved a SAVE, NAME is required if the previous version of NAME is now out of date. 
If it is not a SAVE,NAME1 would enable the user to have two similar versions of the original 
program NAME. ° 

3-7 SAVE (SAVE) 

RACir T h SAV J command is included for BASIC compatibility. It copies the contents of ! 
BAblC work area CI, a blocked disc area, into the disc area specified. The form of the 
command is: 

SAVE, NAME, (N1),(R),(W),(D) 
where: 

NAME Is the disc area on which CI is to be copied. If NAME already exists, a 
straight copy is undertaken. If NAME is not defined, a disc area NAME is created. It is 
blocked, 40 sectors in length, and created on disc pack Nl, where the default N1 is unity 
CI is then copied into NAME. The R, W, and D parameters are as defined for the NEW command. 

The SAVE command works in conjunction with the OLD command, copying the updated 
vers.on of the original program over the old version, or on a new disc area. SAVE should not 
be used m conjunction with the NEW command since NEW does not use CI for any reason 
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SECTION IV 
DEVICE MANIPULATION COMMANDS 

4-1 GENERAL 

_ The device manipulation commands provide ACRONIM disc area and physical device 
positioning The positioning of disc areas is necessary to use the XC command effectively and 
when theREIat.ve mode is set and listing, viewing, and editing record numbers are specified 
Figure 4-1 gives a visual summary of record pointer motion for the various commands. 

The argument lists of the device manipulation commands use the followinq 
abbreviations: a 

D = Physical Device number or Disc Area name. 

Integer value specifying number of files or records to advance or 
backspace. Default is unity. 



Nl 



4-2 ADVANCE FILE (AF) 

The form of the advance file command is : 

AF,D,(N1) 
where: 



pis a physical device number or a disc area name and Nl (default unity), is the 
number of files to advance On completion of this command, the device is positioned so that 
the next record read will be the one following the last file mark read 



4-3 ADVANCE RECORD (AR) 

The form of the advance record is: 

AR,D,(N1) 



With this command, Nl records are skipped from the current position. If a file mark 
is encountered, it is treated as a record. Default Nl Is unity. 



4-4 ADVANCE, BACKSPACE FILE (AB) 

The form of this command is: 



AB,D 
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Figure 4-1. Positioning of Record Pointer 
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AB advances past the next file mark and then backspaces one file mark This 
positions D so that the next record to be read is the next file mark forward from the original 
position. If the end of tape is encountered no file is backspaced. 

4-5 BACKSPACE FILE (BF) 

The backspace file command form is; 

BF,D,(N) 

(N) files are skipped in the backward direction, and, on completion of the BF 
command the dev IC e .s positioned so that the next record to be read will be the N rh file 
mark skipped. 

4-6 BACKSPACE RECORD (BR) 

The backspace record command form is : 

BR,D,(N) 

N records ore skipped in the backward direction from the current position Any file 
marks encountered are treated as a normal record. ' 

4-7 REWIND FILE (RF) 

The rewind file command has the form: 

RF,D 

The previous file mark is backed over and the device is advanced one file mark 
positioning D such that the next record encountered is the first record in the file. If the ' 

uLTn^n ft (B ° T) -• *? d6 r Vice . iS encoun ' ered ' ™ «le * advanced. The RF command 
is essentially a file repositioning function. 

4-8 REWIND AREA (RA) 

The rewind area command has the form: 

RA,D 

Device I C » is backed up until the beginning of tape (BOT) is encountered. The first 
reference (via ACRONIM command) to a disc area rewindTthe area. 

4-9 WRITE FILE MARK (WF) 

The write file mark command has the form: 

WF,D,(N) 
N file marks are written starting at the current file area position. 
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SECTION V 
DISPLAY COMMANDS 



5-1 GENERAL 

There Ore two forms of display commands- List and Vi»«, Tk* ~„i j-m i 

a different meaning for each h,pe of terminal. For a telZ» a «W|S for a"* ' 
me printer .tis 55 lines; and for an alphanumeric terminalit is KnZ I! 
lines as con be output on the CRT without writing on the top topXlme) 



(i.e., as 



many 



after eech Lto o'r View request "when In SEXCS." " L to ."S^T* °1 " "^ 
relative to the current record Dolnter for tk« Jr.. » i i. »■. . Vl,w P° lnf8rs °re 

relative to zero. Whena X£Zu S t X "a U.^ltwScl^ POi ^ R " 
pointer is set to zero. V w mode ' the appropriate 

um.ss J&ZSZZ& r w« h5 . L nd a o?;^fc°on w 7 ft?* ^ Lu - LR < * u ". 

repeater command to VU In general the ZZL ? < 1 W< " enco r unfered / whlch sets ' he 
(eiTher List or View) and withTe ^wcrtoTST?. I T " f <V he J aSt disc «'• displayed 
rt- disc area, the area can'be cttf^s^ *"*•" * *• •»* of 

Is P-rformW ^command is received an automatic update 

changed by a list command If the areaS are n ° f fhe *""* ' he ed it area is not 

The argument lists for the display command use the following abbreviations: 

NAME = Disc Area Name 

rsJn = Integer value 

EOF = End-of-File (Tape Mark) 

EOT = End-of-Tape 

Parenthesized arguments are optional. 
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5-2 LIST AREA (LA) 

The farms of the list area command are; 

LA, (NAME) 

LA,(NAME),N1 

LA,(NAME),N2-N3 

LA, (NAME), FN 1 

LA,(NAME),FN2-N3 

LA, ( NAME), N? -ALL 

LA, ( NAME), N! -EOF 

LA, ( NAME), N I -EOT 

When NAME is not supplied, the disc area currently in the editing mode is assumed. 
N3 must be greater than N2. The Nl form will list only record Nl , whereas the N2-N3 form 
will list records N2 through N3 . If there is no specific request for a record or group of records 
(i.e., the default case), the whole disc area is listed. 

When F precedes Nl or N2-N3, the values of N; are treated as files within the disc area 
and the appropriate files are listed. NT -ALL and N1-EOT starts the listing at record Nl and 
continues to the end-of-tape (EOT) for the disc area. The Nl-EOF starts the listing at record 
Nl and continues through the first file mark encountered. 

Note that when in the Relative mode, all record numbers supplied are relative to the 
currenf position within the disc area. The record numbers output are the absolute values within 
the file. When the numbers given on the LA command refer to files, these are treated as absolute 
file numbers from the beginning-of-tape (BOT), regardless of ACRONIM's Relative or ABsolute 
modes . 

5-3 LIST (LIST) 

This command is included for the BASIC user. The command has any of three forms: 

LIST 

LIST,N1 

LIST,N2-N3 

Nl specifies the statement number to be listed. N2-N3 specifies the range of 
statement numbers to be listed. The command without arguments specifies that all statements 
are to be listed, up to the EOF mark. 
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5-4 VIEW AREA (VA) 

The forms that the VA command can take are : 

VA,NAME,(N1) 
VA,NAME,(N2-N3) 
VA,NAME,(FN1) 
VA,NAME,(FN2-N3) 
VA,NAME,(N1-ALL) 
VA,NAME,(NJ-EOF) 
VA,NAME,(Nl-EOT) 

o-^jH^ 

5-5 LIST UP (LU) 

.. en U^W^STv^^^l^^ ~ «™< ^ b "" «"*' 

LU,(N1),(N2) 



V 



w 



here: 



number of^cordto ^TtJ?™%^Z£ ^ "VT '"J T °* ° nd N2 iS *• 
always be listed. The default for both argument unity ' N2 " redunda ^ one P°9 e will 

5-6 VIEW UP (VU) 

« *. receip, of VU so H», «. vi.vTolTore'o f doToeT^o^ {FcTS K?" 

VU,(N1),(N2) 

5-7 LIST DOWN (LD) 

The list down command is similar in form to LU. 

LD,(N1),(N2) 
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w 



here; 



Nl is the number of pages to displace backward from the current list position to start 
the list output. N2 is the number of records to output. Default for both arguments is unity 
The LD command will only function if a LA or LIST command has been entered previously 



5-8 VIEW DOWN (VD) 



ou 



This command is similar to the LD command. The only difference is that the lines 
tput are not prefixed with record numbers. A VA command must have previously been given 
" the VD to be valid. The form of the command is- 



for the VD to be valid. The form of the command is: 

VD,(N1),(N2) 

5-9 LIST RECORD (LR) 

This command must be preceded by an LA or LIST command which defines the list 
area. The form of the command is; 

LMN1),(N2) 
where: 

Nl is record number in the list disc area at which the lisfl-ino is to start and N2 is the 
number of records to be listed. Note that in the RElative mode, Nl is relative to the current 
record position within the list disc area. The default value for both arguments is unity. 

5-10 VIEW RECORD (VR) 

The View Record command is similar to the LR command. The only difference is that 
each output line is not prefixed with a record number. The form of the command is: 

VR,(N1),(N2) 
A VA command must have previously been given for the View Area to be defined. 
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SECTION VI 
RECORD EDITING COMMANDS 



6-1 GENERAL 



The record editing provides the means to modifv soure* fil»« Tkr— , c a * i 

mands are available: change the contents of a Record ^delete certafnr J« Sf fund< ? men al com ~ 
more new records No editing command is ac^upon S^^| y 7^ a ±S3 S3 L 

commands^Sltl^pt rtt^o^Xdt thti^ T^ T^ 'T^ °" *» **^ 
in order to generate the' ^^ZtS^^^^J^, KaVTc mo'df ?"£ ^ 
works with statement numbers rather than record numbers. ) ' W 

The argument lists of the record editing commands use several abbreviations: 

NAME = Disc Area name 

Nn - Integer value 

TEXT,TEXTr= Character string 

Parenthesized arguments are optional. 
6-2 EDIT AREA (EA) 

This command defines the disc area which is to be edited. The forms of the command 



EA,NAME,(AB) 
EA, NAME, (RE) 



where: 



area was i^f^ ♦t* JS-I- comm °. nd B ™» a " P r ^'ous editing commands regardless of what disc 
clSrS^T^^cidJ " " * al5 ° "^ thC ^^^ P ° interS f ° r th " RC and ^ files and 
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6-3 SPECIAL BASIC EDITING COMMAND (NNN) 

When in the BASIC mode, a command starting with a positive integer is accepted as a 
valid command assuming that a disc area has been set into the editing mode. The statement num- 
ber on the input card is used and stored as the record number. The form of the command is: 

NNN(TEXT) 
where- 

NNN is the statement number and TEXT is the rest of the statement. When TEXT is not 
EharT< R < 9995 ment " NNN '" ""^ ° S ° de,6fe reqU6Sh NNN mUSf have a volu « such 

When an update is performed in the BASIC mode, the newly entered (edited) records are 
sorted m order of statement number and merged with the original disc area. When a statement 
number ,s defmed twice, the last new line entered is used. Delete requests for statement num- 
bers which are not present in the BASIC program are ignored. 

6-4 CHANGE RECORD (CR) 

The change record command allows the records to be modified by supplying their record 
number on the CR card. The form of the command is: P Y 9 

CR,N1,N2-N3 / ... 

For every record number on the CR card, a subsequent input record is treated as a re- 
placement for the Pl^o^ord revested e.g., if CR, 7, 17-23, 5, 9- 12 were entered, the next 
13 ^-- d 2 y° 2 ACRONIM W ou d rep ace in the given order, the following record numbers 

«J CR Z. a f 1 i ' • ' I ' ] ] ' } 2 - A maximum of s^en arguments are allowed on 

one CR card. V/hen a long string of records is to be changed and an error is made, the current 

roTaf m T 9 hr y b ^ er T ated ' P ri °[ 1° completion by entering the editing end-of-mode termina- 
tor $$$. The next input record will be treated as a regular ACRONIM command. 

k fk- WHen ^^NM^ol is assigned to a disc area, any CR commands must be followed 
device ^ re 1 u,red Thus ' th « "«w records come from the ACRONIM input control 

The change record command is not allowed in the BASIC mode. 

6-5 DELETE RECORD (DR) 

The delete record is the same as CR in form: 

DR,N1,N2-N3,... 
where: 

Nl and N2-N3 are record numbers that are to be deleted. There h no limit to the 
number of arguments that may be supplied on the DR command. It is also pos ible to defete files as 
Z foTm ' ^^ ^ ^ ^ ,han ^^ ™ * be deleted the clmand has $ 

DR,FN1,FN2-FN3,... 
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Record numbers may be relative or absolute depending on the current ACRONIM mode. 
File numbers are always absolute. 

6-6 DELETE (DELETE) 

The delete command is included for BASIC use. It is functionally identical to the Dk 
command and has the forms: 

DELETE, Nl 
DELETE, N1-N2 

6-7 INSERT RECORD (IR) 

The Insert Record command allows records to be inserted into the editing area after the 
record number specified on the input card. IR has two different forms which are described in 
the following paragraphs. 

6-7. 1 IR,N1 

In this form NT is the record number in the editing area after which the new records are 
to be inserted. All subsequent records read into ACRONIM are stored as inserts after record Nl 
until the editing end of mode terminator ($$$) is encountered. This terminates the insert mode 
Nl is absolute or relative according to the current ACRONIM mode. An insert for record zero 
is allowed even in the absolute mode. 

6-7.2 IR,N1,NAME 

This form of the command causes all of disc area NAME, from its current record pointier 
position to the end of tape (EOT), to be inserted after record Nl in the editing area. 

The discarea NAME has a record pointer (which is initially the record pointer in the 
disc area table) which is associated with the IR input. This pointer keeps track of the current 
record position. The pointer does not affect the current record position in the disc area table 
held by ACRONIM. 

The IR command can have an alternate form which provides file manipulation: 
IR,Nl,NAME,N2,combinations of AF, CF, BF commands, 
where : 

ri \ dc /f 2 i' S ° Sin ?'f [ ecord ' a arou P of records or a combination of both and the AF (advance 
tile), BF (backspace file), and CF (copy file) commands are intermixed as required. The AF, BF, 
C_h commands apply only to the area from which the insertions are made and are relative to the 
last referenced record in this area on the same IR request. The ACRONIM pointer in this disc 
area is unchanged. 

An example of this form is: 

IR, 5, SAM, 5, 15-18, AF, CF, CF 

The action taken is to insert (after record 5 of the edit area) records 5, 15, 16, 17 and 18 from 
disc area SAM, advance to the EOF mark and insert the next two files from SAM. 
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It is frequently desired to insert records from two different sources (e. g. , a disc area 
and the input device, or two different disc areas) after the same record number in the editing 
area Logically this cannot be done since the second IR request for the same record number 
would wipe out the first. This is still true for IR commands unless the reference to the same re- 
cord number ismode on successive editing commands. When this occurs, the second request is 
appended to the first so that it appears to have been one continuous request. The only exception 
to th.s .s when nothing is inserted for the second request (which is the standard method of erasina 
a previously entered, incorrect editing request). Two examples of error correction are- 



a) IR, 7, INSERT, 14-52 
IR,7 

$$$ 

b) IR,7, INSERT, 14-52 
IR,7,INN,73-256,5-10 
DR,14,18 



IR,7,INN,73-256,5-10 
IR, 7, INSERT, 14-52 



In example a), the insertion after record 7 was incorrect and was erased by followina it 
with another insertion request which inserted nothing. In example b), an insertion after record 
a^AkX . x mvolved records from fwo different disc areas. Further editing (and other 

ACRONIM commands) were entered when it was realized that the insertion had been made in the 
opposite order. By repeating the insert request for record 7 (In the correct order), the previous 
concatenated request was erased to be replaced by the new (correct) concatenated insert. 

The record number • Nl after which the insert is to be made, may be absolute or rela- 
tive depending on the ACRONIM mode set prior to the insert request. The IR command is not 
allowed in the HAblC mode. 

6-8 UPDATE AREA (UA) 

,,. Wheo al I the required editing requests have been entered, an Update Area request 
modifies the edit.ng area file. The form of the command is: 

UA,(NAME) 

where.- 

wr> . NAME is the disc area to which the new, updated version of the program is to be 

wntten The d efault NAME .s the original editing area. If NAME is supplied or if one of the 
work files (CI through C9) is !n rhe editing mode it is the user's responsibility to ensure that the 
output d.sc area will be large enough to hold the updated version of the program. When the 
update is back to the original d.sc area a new, temporary disc area is created (called TP with 
the .terminal appendage - Section l)and its size will be slightly larger than the maximum size 
of the merged original and pre-stored insert, change records (RC) disc areas. This has the added 
convenience that d.sc space is not wasted by having unnecessarily large disc areas allocated. 

CR .„ l ! * h TJ $ a J ecord ! " the , ER mode whi <* has been modified, it is entered as a regular 
CR request and the edit record mode zeroed. The ED area, which contains all the edit requests 
that have been entered, ,s sorted so that the requests are sequentially ordered and that for 
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repetitive requests, only the last entered request is used. Note that in the case of: 



DR5 
CR 5 
NEW RECORD 



record 5 will be changed and not deleted, whereas: 



CR 5 

NEW RECORD 

DR5 



will cause record 5 to be deleted and the chanae reauest will h* ; nnnrB .M tu 

and becomes the new, updated area that was in the editing mode. renamed 

The UA command zeros the name of the disc area in the edit! no m^rl* tk,.« • • 

the input of an EA command before further editing can occur 9 ' ° S reqUmn9 
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SECTION VII 
EDIT AREA MANIPULATION COMMANDS 

7-1 GENERAL 

edit area THe *"' ^ Man?pulaHon command! are used to position the record pointer in tl e 

of the ed^ r "m C e° mmandS """"*'* ' ^ P™" " 1 " 9 hmttton d ° n °' re « uIre ' he »~"«o. ing 

There are several abbreviations used in the argument lists for the commands these -re: 

Nn = Positive integer value 

TEXTn = a character string 

Parenthesized arguments are optional. 

Figure 7-1 provides a visual summary of the positioning of the record pointer for H . 
Advance Commands. The positioning of the pointer in the Backspace command^ ^opemtes in the 
same fashion as the advance pointer positioning. s °P era "»s in the 

7-2 ADVANCE EDIT (AE) 

paragraphlt 16 ° dVanCe ""' C ° mmQnd ha * f ° Ur d?fferenf f ° rmS as descrFbed ! " *• following 

7-2.1 AE,NI 

In this form the AE,N1 advances the edit area Nl records from its current position. 
7-2.2 A E, TEXT 



edit area ^nldV^Z'J^ *"??* fi "?"•'*'«»/ ™4 starting from the current posit 



irion in the 
crers to match J EXT. The search is term 
Hon is set so that the next record read vy 
ing 

7-2.3 A^ Nl, TEXT 



=rZ^S««-'KS=SK* 



'6 

as 
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Figure 7-1. Edit Area Positioning 



Revision B 
May, 1974 
7 -2.4 AEN1-N2, TEXT 

t tpvt ™ S c ° mma " d . Is sf ™ lar fo **>* AE,N1,TEXT command. The difference is that the search 
for TEXT ,. conducted in columns Nl through N2. This form is generally used fo a t exf search 
unless the character string is unique and can appear anywhere on a card 

7-3 POSITION EDIT (PE) 

7-4 BASKS PACE EDIT (BE) 

a ^ e ? a ?. f °n r forms ? f ' he Backspace Edit command and these correspond to the AE 

7-5 ADVANCE NOT EDIT (AN) 

7-6 POSITION NOT EDIT (PN) 

test PN is identical to PE except that the serach is terminated upon not finding the requested 

7-7 BACKSPACE NOT EDIT (BN) 

the given rar ,mand ?§ ^'^ *° BE "^ ^ ' he Search ' erminates U P°" not ""ding 
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SECTION VIII 
CHARACTER EDITING AND MANIPULATION COMMANDS 



8-1 GENERAL 

, Tl ]?, r , e a i: e seven character editing and manipulation commands. The character editing 
commands differ from the line editing commands in that they are not prestored. The request is 
processed immediately upon receipt of the command. The entry of an ER command forces the 
previous record in the ER mode to be entered as a regular CR if it has been modified. The record 
number associated with the ER line is defined when the ER request is entered The last ER re- 
quest is forced to a CR by the UA command. 

When a record is set to the ER mode, the column pointer is always set to zero.* Column 
number references are always considered relative to the current column pointer position. When 
?. P | r ° ces 1 s . or . mocle has °een set or tab values entered independently, the tab values are used as 
field delimiters and editing across the fields is not allowed. 

With the exception of ER, all character editing and manipulation commands are one 
character commands (two or more characters will result in an error, or a wrong command) The 
Change Character command may have any number of pairs of arguments. The Delete Character 
command requires a single argument although multiple arguments can be supplied. 

The abbreviations used in the argument lists are: 

Nn = a positive integer value 

Ni - Nj = a range of positive integer values 

TEXTn = a character string 

NAME = a Disc Area name 

Parenthesized arguments are optional. 

8-2 EDIT RECORD (ER) 

The form of the edit record command is: 

ER,N1 
where: 

Nl is the record number of the record to be character edited. If the Relative mode is 
set, the current record posit.on in the edit area will be added to NT to get the true record num- 
ber, am single character commands entered up to the next ER command apply to record number 
Nl. If a record is already in the ER mode when an ER command is received it is closed out if 
it has been modified by entering it as a changed record in the regular area editing mode. The 
column pointer for the new record is always set to zero. 
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8-3 ADVANCE (A) 

The advance column pointer command has two forms: 

A,N1 
A,TEXT 



w 



here: 



NT is an integer and causes the column pointer to be moved Nl columns forward and 
TEXT is a string of characters, to be searched for from the current column position forward. 
When a match is found, the column pointer is set immediately after the last character of TEXT. 

8-4 BACKSPACE (B) 

The backspace column pointer command has the same two forms as the advance command. 

B,N1 
B,TEXT 

where: 

Nl is the number of columns to backspace the column pointer and the text string TEXT 
is searched for in a backward direction. When a match is found, the column pointer is set 
immediately after the last character of TEXT. 

8-5 POSITION (P) 

Position column pointer has the same form and results in the same action as the advance 
column pointer (Paragraph 8-3) except that before performing the request, the column pointer is 
rewound, i. e. , set to zero. Note that when Nl is supplied, it refers to an absolute column 
position. 

8-6. LIST (L) 

A list request causes the present form of the edit record to be written out from the current 
column position to the end of the record. The number prefixing the output line is the column in 
which the output starts. It is not the edit record line number. 

For a teletype or line printer, the record is output directly. For an alphanumeric ter- 
minal, the output line is written to the output area and then this area is set into the view mode. 
Thus a permanent copy of the output is given and can be retained by redefining the output area 
(Paragraph 2-10). 

8-7 CHANGE (C) 

The character change command has three forms, each of which has two arguments. One 
command may contain several pairs of such arguments. The forms can be intermixed. 
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8-7. 1 C,TEXT1,TEXT2 



placed J TEW Txif V™ /T th * ? rrent col "T P° in ' er fn the forward d?recti ^ ™<* re- 
placed by TEXT2 TEXT! is not allowed to cross tab fields and TEXT2 (which does not have to 

When SlVaTd ?FXT2 ^^^fr ^ f ^ "Tf ^ Ff Ft e *' ends ° ver a * > ™ d 
When TEXT1 and TEXT2 are of different lengths, extra blanks are introduced at the next hiahest 

tab field marker on the card or characters are moved up in the tab field affected and dropped out 
-^t W T^^^ tl 0nly ° ne t0b fFe ' d COn ^ aff6Cted ^ ™y - *" ° f °~ - " 



8-7.2 C,N1,TEXT2 



bv TFXT?^* N1 ^ Ci ^ s fhe "l "?" fr °m rhe current column position that is to be replaced 
8-7 1 considerat.ons and limitation of TEXT2 are the same as defined in Paragraph 

8-7.3 C,N1-N2,TEXT2 

Where N1-N2 is a rorwe of columns (relative to the current column pointer) which 
are to be replaced by TEXT2 The considerations and limitation of paragraph &7. ! aU apply 
to this form of the change character command. pp y 

Note that the current column position is not changed by the change character command. 
8-8 DELETE (D) 

delete re^llZZ"^ ^^ ^ *™ '^ "" fho " °™ f °™ may b « on a single 

8-8. 1 D,TEXT1 

Where TEXT1 is the character string to be deleted. A search is made in the forward 
d.rect.on from the current column position and, when TEXT1 is found it is deleted. he Ze 
number of blanks are brought in at the next higher tab field and the remainder of the characters 
1 Tk *? S leK 2 n T Ve d ° W ? Within the tab ?Ie,d - The d «'erion character str°na canno ™os 
man?™!? "t^ ^ ^-^ is . affec ' ed b / « single argument on a il^cWllrS.. 
mand request. The column pos.t.on pointer is not affected by the delete character commands 

8-8.2 D,N1 

Deletes the character in column Nl relative to the current column position. 
8-8.3 D,N1-N2 

Where Nl -N2 define a group of characters to be deleted relative to the current column 
Zmand. "^ C ° nS?deraHons and 1'mlk.Hons of paragraph 8-8. 1 apply to this form ofThe 
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8-9 INSERT (I) 

The insert character command has six different forms. 

8-9.1 I,N1,TEXT1 

Where NT is the relative column number after which the character string TEXT1 is to 
be inserted. If TEXT1 overlaps the next tab field, it is truncated. The characters squeezed out 
tt ' n f ertlon ar . e dr °PP ed ou* a* *be next higher tab field marker. Only one tab field can be 
affected by a single insert character command request. The current column pointer is unchanged 
by any form of the insert character command. 

8-9.2 I,TEXT1,TEXT2 

Performs the same function as the I command of paragraph 8-9. 1 except that TEXT1 is 
searched for in a forward direction from the current column position and TEXT2 is inserted after 
the lost character of TEXT1 with the same considerations and limitations given in paragraph 

8-9.3 I,N1,NAME,N2 / N3-N4 

Where Nl is the relative column position NAME is a disc area name and N2 is the 
absolute record within the disc area NAME. N3-N4 is a range of column numbers which define 
the characters to be inserted after Nl . N3-N4 can be a single integer if it is desired to insert 
only one character. The considerations and limitations of paragraph 8-9. 1 are applicable to 
this form. 

8-9.4 I,TEXT1,NAME,N2,N3-N4 

This command is the similar to that of paragraph 8-9. 3. The insertion occurs after the 
last character of TEXT1 which is searched for in the forward direction of the edit record from 
the current column position. 

8-9.5 I,N1,NAME,N2 / WN3 

j j l h ,t definIt!ons 9 iven •" paragraph 8-9. 3 apply to this form. W is a prefix to indicate 
word and N3 is an integer greater than zero. This enables a particular word to be found and 
inserted in the edit record. A word is defined as a character string between blank or comma 
delimiters. 

8-9.6 I, TEXT!, NAME, N2,WN3 

This command i$ the same as the command in paragraph 8-9. 5 but the insertion occurs 
afrer the last character of TEXT1 which is searched for In the forward direction of the edit re- 
cord trom the current column position. 
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SECTION IX 
DISC AREA COMMANDS 



9-1 GENERAL 

Th™ «« J. he ., con ? mands fussed in this section deal with direct disc area creation and deletion 
They are similar to some of the file manager commands. When using these commands speed 
care should be taken to ensure that the password is set up correctly? Comma "<*' special 

The abbreviations used in the argument lists of the Disc Area Commands are: 

Nn = a positive integer value 

NAMEn = a Disc Area name 

Parenthesized arguments are optional. 
9-2 GENERATE AREA (GA) 

the command is? mmand Wl " 9eneraf6 m are °' ° f ° s P eclfFed ^P 6 ' °" *• disc. The form of 



GA,NAME,(N1),(N2),(N3),(R),(W),(D) 



where: 



character nt nl • T me l° be 9 ' Ve r *? the , new dlsc area a "d must start with an alphabetic 
Th! % £ nit M m 7n° r 'f SS cha :, a o C f er l in len 9 th - N1 ls fhe "P* ™ 1 ^ze of the area in sectoh 
Sfa ff f Mi •" °> SeCf Z r ,%' L N2 , Is fhe dlsc P ack number °n which to create the disc area The 
tvn!i i' 1 " N ' S ff'S' Q N 3 has . fhree P°«ible forms. It can be an integer digit defining the 
type of disc area (Table 9-1) or it can be the same digit prefaced by "B" indicatinc b 2L.H 

ZW CQn ^ PrefQCed by ° " C "' !ndkaH ^ ** ^dictionar^sl'ldtco;: 9 "orta^ple 



CB6 
ES' fi r#k b p'°w ed *K ° f t/pe 6 ' Wh ° se dictionary »• he'd in core. The default N3 is type Bo 

Table 9-1. Types of Disc Areas 



Area Type 



U <? Data or Word Area 
Background Relocatable Load Module Area 
Background Absolute Load Module Area 
Object Library Area 



Integer Value 



1 
2 

3 
4 
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Table 9-1. Types of Disc Areas (Cont'd. ) 


Area Type 


Integer Value 


Source Library Area 

System Work Area 

Resident Foreground Load Module Area 

Nonresident Foreground Load Module Area 

Nonresident Reentrant Foreground Load Module Area 


5 
6 
7 
8 
9 
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DELETE AREA (DA) 



The Delete Area command will remove the disc area NAME from the disc if the pass- 
words associated with the disc area and set into ACRONIM are the same. The form of the 
command is: 



where: 



DA, NAME 



NAME is the disc area to be deleted. 



9-4 UNSAVE (UNSAVE) 

The UNSAVE command is included for BASIC compatibility. It is identical to the DA 
command. The form of the command is: 

UNSAVE, NAME 
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CHANGE AREA NAME (CA) 

The form of the change area name command is: 

CA,NAME1,(NAME2),(PASS1),(PASS2),(TYPE),(R),(W),(D) 



where : 



NAME! is the old disc area name, NAME2 is the new disc area name, (the default 
NAME2 is NAME1), PASS! is the old disc area password and its default is the ACRONIM pass- 
word last entered via the CK. A zero is allowed to indicate no password. PASS2 is the new 
disc area password. A zero indicates no password and the defauft case is the same as PASS1. 
TYPE can be "C" or "NC" allowing the dictionary status to be changed; C builds the dictionary 

coie, NC removes it from core. R, W, D indicates read, write and delete access, respectively, 
for ihe new disc area, and may be entered in any order. Entry of none of these parameters leaves 
the access the same as on the old NAME1 disc area. If a change to a private (no read, write, 
delete iccess allowed) disc area is required a "P" should be entered after the TYPE parameter 
and the R, W, D omitted. 
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9-6 RENAME (RENAME) 

The RENAME command is included for BASIC compatibility and is identical to the 
CA command. The command has the form : 

RENAME, NAME1,(NAME2),(PASS1) / (PASS2),(TYPE),(R),(W) / (D) 

where: 

the arguments are defined for the CA command. 
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SECTION X 
ACRONIM REGISTERS 



10-1 GENERAL 

There are two discrete types of registers associated with ACRONIM: numeric, and text 
9 ™7 re ? ,srers can contain anypositive or negative integer, over the range -8388608 to 
8JB«60/. A text register occupies three words of memory and may contain up to eight alpha- 
numeric characters. To bu, Id strings of text greater than eight characters, adjacent text registers 
can be treated as an extension of the original. regurers 



Numeric registers are denoted by #0, #1, »2 up to #N where N is the number of 
numer.c agisters set at system generation or modified via the ST command. The text registers 
are denoted by #A, #B, #C up to #N where N is the Nth character of the alphabetic. N is 
def.ned at system generation or via the ST command. The maximum number of text registers Is 
/o and the maximum number of numeric registers is set at 256. 

error sets^O^o' # ° ^^ C ° n ' a ' nS fhe error code from the P reviou s ACRONIM command. No 

a • 5l 9 '?^ m . ay be USed to , re P lace an y regular argument on an ACRONIM command. 
Assuming the following register values exist. 

#1 = 47 #A = TEXT 

2 = 3 I B = NUMBER 

£ = 3 o i C = W,3" 

#4=9 #D = WORD 

commander?" '^ f °"° wln9 commands ' usir >g the registers as arguments, are equivalent to the 

Command using Registers Equivalent Command 

DR#4,#3-1,#2 DR,9,32-47,3 

r h #^Sd ir- #o *. 132, "TEXT NUMBER,5,7,3" 

f£'»?' B ' C ' 2 ' E C,TEXT,WORD,NUMBER,",5,7,3"3/E 

c '* 5 ' A C, #5, TEXT 

A hyphenated text register name acts as a concatenation of the registers. A hyphenated 
numer.c reg.srer is interpreted the same as the case of a range of integers and may only be used 
SfrL'LT 9 ^ f' n k te 9 er * ,s ° n appropriate argument. When a nonexistent numeric register is 
referenced, i w,l be entered as a text argument if the argument could be either a number or 

£. " n u I • °1 6rr .n L° de ,s , our P ut - A non-existent text register, or a text register that 
has no characters ,n it, will be used in its raw form as the text argument. 

., . Re 9* s . ters are Primarily of use when programming ACRONIM to perform interactive 
Snder ACRONIM C ° mmandS - Th ' S SeCtlon ex P lalns the varFous re 9^rer commands available 
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Revision A 
November, 1973 

10-2 REGISTER LOADING ( # N) 

To load the numeric registers, one of four forms may be used, preceding the registers). 
The general forms of the numeric register loading are: 

#1=N1-N2 
#1_3=N1-N2 
*1=NAME,N1,WN2 
# 1-3=NAME,N1,WN2 

The hyphenated loading request indicates tnat the value is to be loaded into the range 
of registers specified. If an arithmetic operator is to be used in loading the register, the form 
shown in example 1 or 2 is used. Nl and N2 are integer values, numeric registers or text 
registers. If a text register is used, it must contain only numeric characters. The allowable 
arithmetic operators are add, subtract, multiply, and divide. More than one operator may be 
used in a command, but there is no hierarchy of operators and evaluation proceeds from left to 
right regardless of the type of operator. The arithmetic expression must be one argument, i. e. , 
no blanks or commas may be embedded. 

When loading a numeric register with a value from a disc area, argument Nl is the 
absolute record number within the area NAME unless Nl is zero in which case the relative 
record zero is used. W signifies a word and N2, which must be greater than zero, determines 
which word in the specified recordwill be used. The word picked out must consist of purely 
numeric characters or an error code will occur. 

The forms of the text register loading are: 

# A=TEXT1&TEXT2:TEXT3;TEXT4 

# A-C=TEXT1&TEXT2 

# A=NAME,N1,WN2 

# A-C=NAME,N1,WN2 

# A=NAME,N1,N2-N3 

# A-ONAME,Nl,N2-N3 

The hyphenated loading request allows the character string to be greater than eight. 
The first eight characters are loaded into the first register indicated, the second eight into 
the next higher register. Any excess registers are set to zero. Too many characters for the 
register range given produces an error code and leaves the original contents unchanged. Forms 
I and 2 must not have blanks or commas embedded (other than in quotation marks). Three 
operators are allowed: an ampersand (&) indicates concatenation, i.e., TEXT2 is appended to 
TEXT1. A colon (:) indicates de-concatenation, i.e., TEXT3 is removed from TEXT1 & TEXT2. 
^failure to find TEXT3 in TEXT1 & TEXT2 results in an error code. A semicolon (;) indicates 
TEXT4 is to be inserted into TEXT1 & TEXT2 at the point where the last de-concatenation took 
place. If no de-concatenation has occurred, the insertion will precede TEXT1. Some examples 
are: 

ABCD&EF = ABCDEF 

ABCD:BC;EFGH = AEFGHD 

ABCD;EF = EFABCD 

ABDC:DC;CD = ABCD 

TEXT I „ TEXT2, TEXT3 and TEXT4 can be text registers or number registers. Forms 3 
jnd 4, are for text register loading from a disc area and are the same as that for the numeric 
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registers. Forms 5 and 6 allow certain characters within a disc area record to be loaded into 
the registers; N2 and N3 are integers specifying column numbers. If N3 is absent, only one 
character will be set into the text register. 

10-3 QUERY VALUE ( QV) 

The Query Value command, which can only be used when ACRONIM control is 
from a disc area, enables the user to interrogate a given register for a specific value. The 
comparison operator may be "=", ">" or "<". If the query is true, the next command will be 
executed. If the query is false, the ACRONIM control disc area will be searched as the SR 
command (paragraph 10-4) for the label presented as the second argument. The form of the 
command is: 

QV,#N=N1,'.JUMP 
where: 

! JUMP is a label on the command disc area, # N is a numeric register and Nl an 
integer. The error code set by the last ACRONIM command is unchanged (unless there is an 
error associated with the QV command itself), thus allowing multiple checks of register zero 
for error code values. 

Querying can be requested for text registers. The comparison takes the following 
form: The number of characters in the two character strings determines if "<" or ">" is true. 
If equal, the characters are compared from left to right, character by character. The ASCII 
representation determines "<" or ">" if they are not the same. "=" occurs only when both 
character strings are identical. 

10-4 SET RECORD (SR) 

Set record has the form: 

SR, NAME, '.JUMP 

where, 

NAME is the disc area name to be searched and ! JUMP is the label. File NAME is 
rewound and the first word of each record compared with '.JUMP. When found,the current 
record pointer for NAME is set so that the first record to be read in is the record containing 
.JUMP. When ACRONIM control is from the disc and the control area is to be searched NAME 
may be replaced by "*" (self). The command is very useful when programming ACRONIM but 
its use is not restricted to ACRONIM control from a disc area. 

10-5 LIST REGISTERS ( L*) 

The list register command has two forms. 

L#,ALL 

L#A,B,C,...,Z,1,2,3,...,N 
L#,A-Z,N1-N2 
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The first form will list ail registers, text and numeric. The second form of the 
command outputs only those registers requested. For alphanumeric terminals the output goes 
to the disc area set into the Output Area mode. This area is automatically set into the View 
mode. The output can be preserved by modifying the Output disc Area. 
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APPENDIX A 
ERROR CODES 

Where an error condition is encountered by ACRONIM an error code is generated. 
The error condition may occur because of illegal command structure, or the inability of the 
system to perform the requested function, or the discovery of system parameters prohibiting the 
operation , or a combination of any of these conditions. 

The error code format is 

CD n 
where: 

n is an integer value specifying the error type. 
Table A-l shows the error codes and definitions. 

Table A-2 explains the possible recovery procedures on some of the more difficult 
error situations. 
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Table A-l . ACRONIM Error Codes 



Code 



Problem 



1 
2 



4 

5 
6 

7 
8 



10 
11 

12 
13 
14 

15 

16 
17 

18 
19 
20 

21 

22 
23 
24 
25 
26 
27 
28 
29 

30 

31 
32 



33 
34 
35 



Card Error/Syntax error 

Allocation failure after 5 tries. (100 millisecond delay betv/een 

attempts) 

Disc area table full. A Delete Table command is required to 

create more space. 

Cannot output directly to alphanumeric terminal. 

First I/O device or disc area name is invalid. 

Second ]/0 device or disc area name is invalid. 

Third ]/<D device or disc area name is invalid. 

Invalid Command. Not a two character ACRONIM command, or $ NAME 

is notpresent or is not a foreground program, or User Number not given. 

BASIC statement number error. Statement must be greater 

than zero and less than 10000 (1-9999). 

No file in editing mode. 

Not in BASIC mode . Command attempted allowed only 

in BASIC mode. 

^/O request to anptjjeirjerminal. 

Copy "area" onlyjjpplicable to disc input. 

Initialization request must be first card after $OFF. Put SU 

command immediately following $OFF command. 

Unexpected end-of-tape read in. Note that some of the 

commands may have been performed. 

End-of-tape on output disc area. Disc area too small. 

Invalid standard disc area name (Set Up). Name must be 

CI through C9 or RC 

Too many ( >8) numbers on tab value card. 

Cannot change processor mode when editing. 

Not a mode value variable, modes to this one have 

been set. 

Basic work file (CI) not present. Issue $OFF and SU 

command defining CI. 

Disc area name already exists, or not enough space. 

Basic statement number out of 1-9999 range. 

Edit file full, do an update. 

End-of-tape on RC file, do an update. 

RC disc area cannot be set to zero. 

No edit area defined. Issue appropriate command. 

ED area too small (can't occur unless user modified). 

Edit area no longer on disc. The disc area has been 

deleted, via background or another terminal. 

Can't create scratch work area (TP), more room required 

or already present. Delete TP. 

Output area too small, updated to end-of-tape. 

Core allocation problems ot end of update. Delete edit 

area name (may already be deleted), rename TP to edit 

area name just deleted. 

RUN name not same as edit area name. 

Not allowed in BASIC mode. 

Cannot find requested file(s). Searched to end-of-tape. 



A-2 



86 
87 



Code 



36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 
47 
48 

49 
50 
51 
52 
53 
54 
55 

56 

57 

58 

59 

60 

61 

62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 

81 

82 

83 

84 

85 



Invalid work area specified on DW command 
Too many arguments on DW command 

Table A-l . ACRONIM Error Codes (Cont'd) 



Revision B 
May, 1974 



Problem 



New area name already exists. 

Cannot rename or delete standard terminal disc area 

Disc area is non-existent. 

No disc area name supplied. 

No list or view area defined. 

Non-BASIC record found in disc area. 

List, view request beyond end-of-tape. 

Cannot delete the defined output disc area 

Key (password) must have an alphabetic first character. 

Edit requests were made for records after end-of-tape. 

These are ignored. 

Cannot delete or change line number zero. 

Too many ( >7 ) arguments on change record card. 

Beginning or end-of-tape found on search request, 

TEXT not found. 

Column number is out of 1 -80 range. 

Number of characters in TEXT > defined search columns. 

Edit record set to an EOF or end-of-tape record. 

Requested TEXT not found within the edit record. 

No output area is defined. 

There is no edit record defined. 

The record referenced for an insert edit line is an EOF 

or end-of-tape. 

The requested word in the line does not exist. 

Deletion requested across tab field column 

Non-existent register(s) referenced. 

Register (s) not large enough forgiven TEXT 

Command only valid if ACRONIM control from disc area. 

Only numeric values are allowed in number registers. 

Requested deconcatenated TEXT not found. 

More than 80 characters building TEXT for TEXT registers. 

List values or View Values out of range. 

Invalid name requested deleted from the disc area table. 

The register size(s) requested are beyond the maximum. 

The disc area does not contain a valid Job card as first record. 

Invalid Job card parameter. 

Invalid or non-existent user number. 

Invalid output device ($JOB or IJ). 

SON treated as $OFF. Repeat $ON. 

Illegal User number. 

Edit record number greater than 32767. 

User number has not been entered. 

Illegal password. 

Old disc area non-existent or new disc area already exists. 

Updating failed to rename 'TP' to Edit area name. 

Update failed because Edit area is "delete protected". 

Register Setting command is Invalid. 

Buffer Size cannot exceed 999 characters. 

Illegal PDN as first parameter on "SM" 

Illegal "SM" Optional Parameter 

No transport was specified on "SM" card 

Non-existent disc area to be spooled 

Invalid PDN as spool out device 
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Table A-2. Recovery Procedures 



Code 1 
Code 2 



Code 3 
Code 15 
Code 16 

Code 19 

Code 20 

Code 21 

Code 24 



Code 25 



Code 26 
Code 28 

Code 30 



is basically a syntax error and the example commands given in 
Section 2 through 10 should be consulted. 

When dynamic core is requested (by all ACRONIM programs), five 
attempts are made to obtain the core with a 100 millisecond wait 
between each try. The only solution to code 2 is to keep hying the 
same command or another which may cause a smaller program to 
be loaded. 

Disc area table full requires some form of the Delete Table 
command to create more space. 

The end of the input device has been reached before completing 
the request; some of the request may be done. 
The output device is too small for the operation requested. The 
device will be filled up to the point the end-of-tape was 
encountered. 

The processor mode is not changeable after the edit mode is set 
and the first editing command has been entered. The tab values 
can be modified via TV. 

On the MV card, the modes are set as the arguments are inter- 
preted. On encountering an invalid mode value, the rest of the 
arguments are ignored. 

Basic programs are not able to utilize the OLD command 
without CI. The only solution is $OFF, start the terminal up 
and enter a SU card defining the size of CI . This is also the 
solution should CI not be large enough to contain the program. 
The ED disc area is full. The user should do an update area and then 
carefully check that the last editing command entered has been 
satisfied completely. All commands issued before the last should 
be unaffected by the ED space failure. Note that if there is a 
record in the Edit Record mode, it probably will be lost since on 
an update request this record is entered as a change record command 
and ED is full. For code 24 to occur more than 370 records must 
have been requested. 

The end of the RC file has been encountered. As for code 24, an up- 
date area should be issued and the last editing command that was 
entered checked carefully to ensure that it has completely been 
satisfied. Prior editing commands should be unaffected by the RC 
space failure. A record in the Edit Record mode will probably be 
lost, since it is entered as a change record and the RC area is 
full. For this error to be minimized, the user has control over the 
size of his RC area, via the SU card. Default RC is 240 sectors. 
On the SU command, the RC disc area may not be zeroed even if 
no editing is to be undertaken. 

ED disc area is too small. This is an impossible error unless the 
size of the ED area has been changed by the user. It is normally 
20 sectors, and if the user changes this he runs the risk of his 
updated Area requests not being processed. 

Generally cannot occur. When it does occur, it frequently follows code 
code 32. Failure to create the scratch file TP occurs because it 
is already present (possible after code 32) or there is not enough 
contiguous space on the disc. If deletion of TP does not work, the 
only way to achieve the UA is by deletion of other, contiguous, 
disc areas to create a large enough space on the disc in which 
TP can be generated. The TP area may be deleted with DW.TP 
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Table A-2. Recovery Procedures (Cont'd) 



Code 31 



Code 32 



Code 35 



Code 37 

Code 43 
Code 45 

Code 46 
Code 48 

Code 60 



The output disc area is too small. The area will contain the updated 
version of the program until space ran out. The rest of the updated 
version is lost. Code 31 will only occur for UA,NAME when NAME 
is too small or if the editing area is a terminal work area (C1-C9). 
When UA is to the same area as the edit area name, the area generated 
is always large enough. 

This is the most difficult error in ACRONIM to rectify. On completion 
of the UA it is generally necessary to delete the edit disc area and 
change the name of TP to the ex-edit disc area name. Both of these 
operations require the allocation of core and, if the core is not available, 
code 32 results. Thus, the user must first try a DA, NAME to delete the 
old edit area. This may have already been accomplished so an error code 
38 is acceptable. The user must then enter a CA,TP/XX,NAME. Where 
XX is the octal representation of his input terminal physical 

device number and NAME is the old edit area name just deleted. 

For DR and IR requests concerning files in a disc area, an end-of-tape 

has been found before the appropriate files requested. None of the 

edit command has been stored. 

The terminal work disc areas cannot be deleted or renamed. (They 

can be set to zero, i.e., deleted via the SU command.) 

The output disc area must be defined for alphanumeric terminals. 

Edit requests referencing record(s) beyond the end of tape of the 

edit area have been found. These requests are ignored. 

Record number zero (Absolute mode) cannot be changed or deleted. 

A beginning or end-of-tape was found while searching for the given 

TEXT. It cannot be found. 

Certain commands are only valid when ACRONIM command input is 

from a disc area. 
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APPENDIX B 
EXAMPLES OF ACRONIM USAGE 



Example 1. 

Generate an area and enter an Assembly language program. Assemble the program. 
Procedure : 

$ON User Number 
GA,EXAMP1,50 
MV,AS,AB 
RC*,EXAMP1,F 

: I 

( Enter program statements 

$EOF 

NOTE 1: 

If a preliminary edit is to be done, the following 
statements can be entered. 

EA, EXAMP1,AB 
LA, 1 -EOF 

NOTE 2: 

At this point any required record editing commands 
(CR, DR, IR) or character editing commands (ER, A, 
B, P, L, C, D, I) may be entered, e. g. , Record 5 is 
to be deleted, and Record 10 needs to be changed 
from "TAM D" to "TDM D". 

DR,5 

ER,10 

C,A,D 

NOTE 3: 

Having entered the changes the area is ready for 
updating and assembly. 

UA 

$JOB 

$ASSIGN 7,EXAMP1 

$ASSEMBLER 

$EOJ 
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NOTE 4 : 

The Assembler listing will be printed on the terminal's 
printer or screen. If additional editing is required, 
the area EXAM PI must again be put in the editing 
mode. Refer to the command stream following Note 1 
for the procedure. 

Example 2: 

Generate an area and copy contents of file EXAMP1 onto it. Add more assembler 
language source statements to the new area. 

Procedures: 

$ON User Number 

GA,EXAMP2,70 

MV,AS,AB 

RQEXAMP1, EXAMP2,F 

BF,EXAMP2 

XC,\EXAMP2,F 

: i 

. f Enter program statements 
$EOF 

Example 3: 

Generate an area and copy the contents of EXAMP1 and EXAMP2 onto the area. 
Delete the file mark between EXAMP1 and EXAMP2. Delete EXAMP1 area. 

Procedures: 

$ON User Number 
GA,EXAMP3,80 
RC,EXAMP1,EXAMP3,F 
BF, EXAMP3 

XC,EXAMP2,EXAMP3,F 
DA, EXAM PI 

Example 4: 

Copy the first 7 records from EXAMP1 onto EXAMP4. Copy the 25th through the 57th 
records of EXAMP3 immediately after the EXAMP1 record. 
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Procedure: 

$ON User Number 

GA,EXAMP4 

RC,EXAMP1,EXAMP4,R,7 

RA,EXAMP3 

AR,EXAMP3,24 

XC, EXAMP3,EXAMP4,R,33 

WF,EXAMP4 

Alternate Procedure using Record Editing commands. 

$ON User Number 

GA, EXAMP4 

WF,EXAMP4 

EA,EXAMP4 

IR,0,EXAMPl,l-7 

IR,0,EXAMP3,25-57 

UA 

t 

Example 5: 

Program ACRONIM to find all references to a specified label within a block of source 
code. The ACRONIM program is copied onto disc area CI and control is passed to that area^ 
Whenever a record containing "LABEL is found in disc area EXAMP5, it will be listed with : 
the line number. 

Procedure: 

'JON User Number 

RC,*,C1,F 

MV,RE 

RA,EXAMP5 

EA,EXAMP5 

: LOOP,AE,LABEL 

QV, #0=48,.' CONTINUE 

MV,AB 

CI 

: CONTINUE,LA>° 
SR, CI,.' LOOP 
$EOF 
RI,C1 

Example 6: 

The problem definition of EXAMP5 will be used here. In addition to performing the 
functions of EXAMP5, "LABEL" will be changed to "NAME". 
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Procedure: 

SON User Number 

# A-L.ABEL 

# B-NAME 

RC,*,C1,F 

RA, EXAMP5 

ea,examp5,re 
:loop,ae,*a 
07/0=48, j continue 

UA 

MV,AB 

CI 

:CONTINUE,LA,0 

ER,0 

C,#A,#B 

SR,*,!LOOP 

$EOF 

RI,C1 
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